home *** CD-ROM | disk | FTP | other *** search
/ Aminet 30 / Aminet 30 (1999)(Schatztruhe)[!][Apr 1999].iso / Aminet / dev / cross / dz80.lha / dz80 / dz80.readme < prev    next >
Text File  |  1999-02-19  |  2KB  |  71 lines
  1. Short:    DZ80 v1.31 Labelling z80 disassembler
  2. Author:   Mark Incley <dz80@inkland.demon.co.uk>
  3. Uploader: Dominic Morris <djm@jb.man.ac.uk>
  4. Type:     dev/cross
  5.  
  6. DZ80 v1.31
  7. ----------
  8.  
  9. (C) Mark Incley 1996-8
  10. Amiga port by Dominic Morris
  11.  
  12. Introduction
  13. ------------
  14.  
  15. Yup, it's another port of a PC utility for z80 programmers! DZ80 is a
  16. labelling z80 disassembler, this is the disassembler that I used to create
  17. the z88 port of the Spectrum game Sir Lancelot. The port was made using 
  18. DICE and required only a few modifications - if you run into problems, I've
  19. probably not changed a definition!
  20.  
  21. Usage
  22. -----
  23.  
  24. [snipped from program]
  25.  
  26. --
  27. Disassembles a Z80 binary file.            E-mail: dz80@inkland.demon.co.uk
  28.  
  29. DZ80 [switches] Z80file [Output Assembly File]
  30.  
  31.   /H=nn     Skips past the first nn bytes of the input file.
  32.   /M=nn     Specifies whereabouts in Z80 memory the source file starts.
  33.   /S=nn     Specifies the address to start disassembling from.
  34.   /E=nn     Specifies the ending disassembly address.
  35.   /R=file   Specify the name for the reference file. Used with /XA /XN /XO /XI.
  36.   /XI       Create reference of input ports.
  37.   /XO       Create reference of output ports.
  38.   /XA       Create reference of addresses.
  39.   /XN       Create reference of indirect addresses.
  40.   /XR       Limits references to those outside the disassembly range.
  41.   /L        Create a labelled (assembleable) output file.
  42.   /P=opmap  Use an opcode map to determine the addresses to disassemble.
  43.  
  44. If no output file is specified, dZ80 will disassemble to the screen.
  45.  
  46. Example: DZ80 /h=27 /m=16384 /s=32768 /e=40549 mayhem.sna
  47.  
  48.  
  49. Changes from PC version
  50. -----------------------
  51.  
  52. The output disassembly is suitable for compilation by the z80 assembler
  53. by Gunther Strube/Interlogic (Amiga port available from Z88 Forever at
  54. http://www.menaxus.demon.co.uk/z88/z88home.htm), all that is needed is the
  55. addition of a MODULE line.
  56.  
  57. As a result, all hex numbers are prefixed by a $ and all labels by '.' - no
  58. trailing colon is appended (contrary to standard notation, but if you are
  59. developing z80 projects then you really should be using the Interlogic
  60. assembler!)
  61.  
  62. The source code for dz80 is available from Mark Inclands site at
  63. http://www.inkland.demon.co.uk
  64.  
  65. Thanks to:-
  66.  
  67. Mark Incland for such a nice disassembler and allowing its distribution.
  68.  
  69. 17/2/99
  70. EOF
  71.